home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Franz PD / Franz PD Disk #279 (1993)(Rhein-Sieg-Soft).zip / Franz PD Disk #279 (1993)(Rhein-Sieg-Soft).adf / AKCC_V3.02.LHA / AKCC / akcc_gen0-Library / akcc_gen0.library.doc < prev    next >
Text File  |  1993-11-01  |  8KB  |  279 lines
  1.  
  2.              akcc_gen0.library V37.1
  3.  
  4.                 - FREEWARE -
  5.  
  6.          © 1989-93 by Andreas R. Kleinert. Alle Rechte vorbehalten.
  7.  
  8.           Dieses Programm wurde unter OS V3.00 geschrieben und ist
  9.           deshalb voll kompatibel. Es benötigt OS >= V1.2.
  10.  
  11.           Nachfolge-Library der "akcc.library".
  12.  
  13.           Release Datum : 01.11.1993
  14.  
  15.  
  16.     Distribution :
  17.     ==============
  18.  
  19.     Dieses Programm darf frei weitergegeben werden. Sie dürfen es kopieren,
  20.     falls der Copyright-Vermerk erhalten bleibt und dieses Doc-File Teil
  21.     der Distribution bleibt.
  22.     Dieses Programm darf ohne meine schriftliche Erlaubnis nicht nicht in
  23.     kommerzielle Programm-Pakete oder "-Kollektionen" miteinbezogen werden.
  24.     Kopiergebühren sollten die tatsächlichen Kosten nicht übersteigen.
  25.  
  26.     Die Verwendung der "akcc_gen0.library" für eigene Programme ist nur mit
  27.     meiner schriftlichen Erlaubnis gestattet.
  28.     Ich bin gerne bereit, Interessierten gegen DM 10,- (Porto, Papier, VP)
  29.     die neueste Version der "akcc_gen0.library" plus Dokumentation (Übergabe-
  30.     parameter, Funktionen, Offsets, Link-Code) und schriftlicher Erlaubnis
  31.     zuzusenden.
  32.     Dieses Angebot gilt nur fuer PD-, FW- oder SW-Programmierer !
  33.     Kommerzielle Interessenten können Näheres bei mir erfahren.
  34.  
  35.  
  36.     Installation :
  37.     ==============
  38.  
  39.     Kopieren Sie die "akcc_gen0.library" einfach in das "LIBS:"-Verzeichnis
  40.     Ihrer Diskette.
  41.  
  42.  
  43.     Intention :
  44.     ===========
  45.  
  46.     Die "akcc_gen0.library" findet z.B. Verwendung in den von mir
  47.     geschriebenen AKCC-Befehlen und enthält viele Funktionen, die die
  48.     Programmierung z.B. von Dos sehr erleichtern.
  49.  
  50.  
  51.     Bedienung :
  52.     ===========
  53.  
  54.     Die "akcc_gen0.library" beinhaltet ...
  55.  
  56.      - Funktionen zum komfortablen Umgang mit der DosLibrary allgemein
  57.      - Patternmatching-Funktionen :
  58.  
  59.     - unter OS V1.3  : ?, #?, *, ~(...), (...|...|...)
  60.     - unter OS V2.04 : ZUSAETZLICH Unterstützung aller normalen
  61.                DOS-WildCards inklusive Stern (*), z.B. :
  62.  
  63.                 ~(Hallo#?|IhrDaDraussen*)
  64.  
  65.      - Funktionen für Environment-Variablen
  66.      - Viele Funktionen, die es ansonsten erst ab OS V2.04 gibt
  67.  
  68.        (Assign, Ermitteln eines kompletten Pfad-Namens, ...)
  69.  
  70.  
  71.     Korrespondenz :
  72.     ===============
  73.  
  74.        Andreas R. Kleinert,
  75.        Grube Hohe Grethe 23,
  76.        D-57074 Siegen,
  77.        Germany.              email : ...
  78.  
  79.  
  80.     Geschichte :
  81.     ============
  82.  
  83.      Für die "Geschichte" der akcc.library (die nicht mehr weiterentwickelt
  84.      wird) sehen Sie in deren Doc-Files.
  85.  
  86.  
  87.      AKCC_GEN0-V37.1 :
  88.      -----------------
  89.  
  90.      - neue Funktion(en)
  91.      - kleinere Verbesserungen
  92.  
  93.  
  94.      AKCC_GEN0-V36.66 :
  95.      ------------------
  96.  
  97.      - once again : WildCard-Fehler korrigiert (optimizations :
  98.        KEIN optpeep und KEIN optglobal)
  99.      - kleinere Korrekturen
  100.  
  101.  
  102.      AKCC_GEN0-V36.65 :
  103.      ------------------
  104.  
  105.      - Nochmal die 2.04-WildCard-Routine : Guru "memory header not located"
  106.        konnte auftreten. Jetzt nicht mehr (hoffentlich ...).
  107.      - Verwendung von SAS/C V6.3
  108.      - u.a.
  109.  
  110.  
  111.      AKCC_GEN0-V36.61 :
  112.      ------------------
  113.  
  114.      - Wieder die 2.04-WildCard-Routine : ALLE verglichenen ORIGINAL-Strings
  115.        wurden in uppercase umgewandelt. Jetzt nur noch die Kopien. Sorry.
  116.      - u.a.
  117.  
  118.  
  119.      AKCC_GEN0-V36.60 :
  120.      ------------------
  121.  
  122.      - Fehlerkorrektur : 2.04-WildCard-Unterstützung war deskativiert,
  123.        außerdem weitere (mögliche) Fehlerquelle in den WildCard-Routinen
  124.        korrigiert.
  125.  
  126.  
  127.      AKCC_GEN0-V36.58 :
  128.      ------------------
  129.  
  130.      - Beim Optimieren haben sich (leider) einige Fehler ergeben
  131.        (WildCard-Routine, Datums-Routine, ...), so daß eine neue
  132.        Version (nicht ganz so "optimiert" ...) erforderlich wurde.
  133.        Fehler ist jetzt korrigiert.
  134.  
  135.  
  136.      AKCC_GEN0-V36.57 :
  137.      ------------------
  138.  
  139.      - Verwendung des Global Optimizer von SAS/C V6.00
  140.  
  141.  
  142.      AKCC_GEN0-V36.xx :
  143.      ------------------
  144.  
  145.      - Verwendung von SAS/C V6.00
  146.      - Verringerung der Code-Größe
  147.      - Beseitigung von upper-/lower-case-Problemen in der WildCard-Routine
  148.  
  149.  
  150.      AKCC_GEN0-V36.17 :
  151.      ------------------
  152.  
  153.      - Beseitigung diverser Irritationen mit der Versionsnummer
  154.        (V36.12 oder V36.15 ???)
  155.      - Ergänzung der OS V1.3-WildCards um logisches ODER und NICHT,
  156.        sowie den Klammer-Operator.
  157.        Folgende Ausdrücke sind möglich :
  158.  
  159.     - (...)
  160.     - ~(...)
  161.     - Für "..." können sowohl ein normaler WildCard,
  162.       als auch beliebig viele ODER-Argumente stehen :
  163.       <Exp1>|<Exp2>|<Exp?>|<Expn>
  164.     - Außerdem besteht die Möglichkeit, den ODER- und den
  165.       NICHT-Operator auch ohne Klammer(n) einzusetzen !!!
  166.     - verschachtelte Klammern sind prinzipiell möglich, ein
  167.       ODER-Operator darf jedoch nicht aus weiteren
  168.       geklammerten ODER-Operatoren bestehen !!!
  169.       (Ist im übrigen auch relativ sinnlos !!!)
  170.  
  171.  
  172.      AKCC_GEN0-V36.15 :
  173.      ------------------
  174.  
  175.      - Die Pfad-Routinen (Hinzufügen, Entfernen) funktionieren jetzt auch
  176.        unter OS V2.04 fehlerfrei : Es hat sich herausgestellt, daß unter
  177.        DOS V2.04 AllocVec() bzw. FreeVec() hier Verwendung finden.
  178.        Unter OS V1.2/V1.3 muß logischerweise AllocMem() bzw. FreeMem()
  179.        verwendet werden, da die ...Vec()-Funktionen erst ab V36/V37
  180.        existieren.
  181.        Der Guru "memory header not allocated" sollte also nicht mehr
  182.        auftreten.
  183.        (Falls doch, bitte ich um Benachrichtigung !!!).
  184.  
  185.  
  186.      AKCC_GEN0-V36.12 :
  187.      ------------------
  188.  
  189.      - Wesentlicher Fehler aller früheren Versionen - im Zusammenhang mit
  190.        Registerparametern in A1 - korrigiert.
  191.      - verbesserte Docs (Sie lesen sie gerade ...)
  192.  
  193.  
  194.      AKCC_GEN0-V36.8 :
  195.      -----------------
  196.  
  197.      - "Programm-Kosmetik" :
  198.  
  199.     - Änderungen in den Includes und im Startup-Bereich
  200.       sowie im MakeFile
  201.  
  202.      - Programmier-Dokumentation (bis jetzt nur für autorisierte Anwender) :
  203.  
  204.     - Dokumentation der Funktionen
  205.     - LinkLibrary-File
  206.     - Demo-Programm mit ".fd" und ".bmap"-Files für Basic-Programme
  207.  
  208.  
  209.      AKCC_GEN0-V36.7 :
  210.      -----------------
  211.  
  212.       - Integration von fünf neuen Funktionen zur Pfad-Verwaltung,
  213.     zum Text-Parsing und zur String-Bearbeitung
  214.  
  215.  
  216.      AKCC_GEN0-V35.45 :
  217.      ------------------
  218.  
  219.       - unter OS V2.04 : ZUSÄTZLICH Unterstützung aller normalen
  220.              DOS-WildCards inklusive Stern (*), z.B. :
  221.  
  222.               (Hallo#?|IhrDaDraußen*)
  223.  
  224.  
  225.      AKCC_GEN0-V35.28 :
  226.      ------------------
  227.  
  228.       - verschiedene Dinge im Doc-File korrigiert
  229.       - "ExpungeLib" funktioniert jetzt fehlerfrei
  230.       - Funktion "AKCC_ReadEnv()" korrigiert.
  231.     (Nullbyte am Ende fehlte.)
  232.       - Gewinn einiger Bytes (26 : Yeaah !!!)
  233.       - usw.
  234.  
  235.  
  236.      AKCC_GEN0-V35.11 :
  237.      ------------------
  238.  
  239.       - erhebliche Verbesserung der WildCard-Routine.
  240.     Weniger fehleranfällig. "Neuheiten" :
  241.  
  242.            "**" wird als "*" interpretiert
  243.            "#?" wird als "*" interpretiert (wie gehabt)
  244.     aber : "?"  steht für EIN einzelnes Zeichen
  245.            "#"  ist (alleinstehend) NICHT erlaubt
  246.  
  247.       - Unterstützung des "$VER"sion-Strings von OS >= V2.04
  248.  
  249.  
  250.      AKCC_GEN0-V35.3 :
  251.      -----------------
  252.  
  253.       - Fehler in der AKCC_FPrintf-Routine beseitigt.
  254.     War auf 256 Zeichen beschränkt, was zum Absturz führen konnte.
  255.     Jetzt werden 1024 Zeichen (+ Sicherheit von 176 Zeichen) unterstützt.
  256.     Insgesamt 1200 Zeichen sind also möglich.
  257.  
  258.  
  259.      AKCC_GEN0-V35.2 :
  260.      -----------------
  261.  
  262.       - Umbenennung von "akcc.library" in "akcc_gen0.library"
  263.     wegen einschneidender Veränderungen und daraus resultierender
  264.     Inkompatibilität (s.u.)
  265.       - Reduzierung auf die wichtigsten Kernfunktionen
  266.     (keine "Shell"-Funktionen für die DOS-Funktionen mehr - trotzdem
  267.      keine realen Leistungseinbußen)
  268.       - Verbesserung der Stub-Routinen ("scattered" linking)
  269.       - starke Code-Verkürzung durch Reduzierung der Funktionen
  270.       - drei neue Funktionen für den Env-Support
  271.       - Funktion für einfache "Assignments"
  272.       - Codeoptimierungen
  273.       - Re-Integration der BPTR
  274.     (selbst unter OS V2.04 muß man mit BPTRn leben ...)
  275.       - Volle Nutzung von Registerparametern
  276.     -> deshalb jetzt auch Nutzung von PRAGMAs möglich (SAS/C V5.10a)
  277.  
  278.  
  279.